home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / ramail30.zip / RAMCONF.DOC < prev    next >
Text File  |  1991-08-01  |  7KB  |  146 lines
  1.  
  2.  
  3.                            RAMail Configuration v1.4
  4.                     Copyright 1990, 1991 by Randy Blackmond
  5.                               All Rights Reserved
  6.  
  7.      RAMCONF is the configuration program for RAMail. Until version 2.3 of
  8.      RAMail, RAMCONF never had any real documentation because I felt that
  9.      it was straightforward enough not to need it. I still feel this way,
  10.      but being the programmer, things that seem perfectly clear to me may
  11.      be confusing to someone else. This file is provided for those people who
  12.      may need clarification on some of the items in the RAMCONF program.
  13.  
  14.      First, I'll offer a little general information on moving around the screen
  15.      among the different fields. There are three ways to move from field to
  16.      field. These are the ENTER key, the TAB key and the cursor keys.
  17.  
  18.      Pressing the ENTER or TAB key will move to the next field. The up and
  19.      down cursor keys behave a little differently, but experimentation will
  20.      get you used to their actions. The left arrow key will move you to the
  21.      field to the left or the previous field only if the cursor is at the
  22.      leftmost position of the field. The right cursor behaves the same way
  23.      at the rightmost position of the field.
  24.  
  25.      If you press ESCape from the Main Window, the program will terminate
  26.      without saving any changes you may have made. Pressing ESCape from any of
  27.      the subwindows will return you to the Main Window. Changes made to fields
  28.      inside subwindows are "remembered" so ESCape does not abort changes made
  29.      to fields in subwindows, however, the changes made to those fields will
  30.      be lost if you press ESCape from the Main Window.
  31.  
  32.      Pressing Escape from the Main Window will bring up the Exit Window. From
  33.      this window, you have the option of saving the configuration and exiting,
  34.      exiting without saving the configuration or cancelling the exit and
  35.      returning to the program.
  36.  
  37.      Most of the fields are pretty self-explanatory, but I will elaborate on
  38.      some that might be misconstrued and can cause problems if this happens.
  39.  
  40.      The Path to CONFIG.RA is just that. The drive and directory where your
  41.      CONFIG.RA resides, i.e. your main RA system directory.
  42.  
  43.      The Path to EXITINFO.BBS is where RAMail should look for this file. If
  44.      you are running a single node system, the entry you make here should
  45.      duplicate the Path to CONFIG.RA entry. If you run multiple nodes, this
  46.      should be the path to the particular node directory that for which this
  47.      configuration is to be used.
  48.  
  49.      The Path to RAUSER.DAT is where you want RAMail to create and look for
  50.      the RAUSER.DAT data file. This can be anything you want.
  51.  
  52.      The Local Mail Directory is the drive and directory where RAMail should
  53.      place .QWK packets when someone is logged on locally as well as where
  54.      it should look for .REP files when logged on locally. This should NOT be
  55.      the same directory where RAMail resides!
  56.  
  57.      The Required Conferences field allows you to specify which, if any, boards
  58.      should be included in ALL users' mail packets. For example, if you want
  59.      boards 1, 3, and 20 to be included in all user's packets, you would enter:
  60.      1 3 20
  61.      in this field. Leave it blank if you don't want to force any boards.
  62.  
  63.  
  64.  
  65.      The next five Limit fields allow you to specify the maximum number of 
  66.      messages that RAMail will place into a mail packet for each baud rate.
  67.      The five fields to the right of the message limits are messages limits
  68.      on a Per Conference basis.
  69.  
  70.      The Default File EXT is what most of your downloadable BBS files use an
  71.      extension. For example, if most of your files are compressed with PKZIP,
  72.      the extension would be ZIP. This allows for users to flag files without
  73.      having to specify an extension. This default extension will be used when
  74.      the extension is omitted during flagging.
  75.  
  76.      The Check # of Messages toggle will allow you to tell RAMail whether or
  77.      not it should determine what the highest numbered message is during the
  78.      Conference Selection. If your users get an unusually long WAIT! prompt
  79.      when selecting conferences, you may want to set this toggle to N.
  80.  
  81.      The Board Toggles will allow you to set the Lo Bit, Hi Bit and Tagline
  82.      Stripper toggle and the short name for EACH message board. The Short Name  
  83.      field will be used in the QWK packets generated by RAMail. If you neglect
  84.      to enter a short name, the first 10 characters of your normal board name
  85.      will be used.
  86.  
  87.      All of the rest of the toggle fields turn off various menu options on the
  88.      RAMail menu.
  89.  
  90.      The Compression Method fields allow you to specify which compression
  91.      programs you want to support when compressing the mail packets. The user
  92.      can pick one of these methods from the RAMail menu. 
  93.  
  94.      The first field, Compression Name, is the descriptive name of the method. 
  95.      Anything is allowable in this field.
  96.  
  97.      The Compression Program field is where you place the name, with extension,
  98.      of the compression program. The path is not required, but the program
  99.      MUST reside in a directory that is included in your DOS path.
  100.  
  101.      The Decompression Program entry follows the same rules as those of the
  102.      Compression Program entry.
  103.  
  104.      The Compress Command Options allows you to specify command line parameters
  105.      that the compression program will use when compressing files. This field
  106.      is optional IF your compression program requires no paramaters other than
  107.      the file names.
  108.  
  109.      The Decompress Command Options entry follows the same rules as those of
  110.      the Compress Command Options entry.
  111.  
  112.      The Protocols subwindow contains fields that you must fill to define your
  113.      transfer protocols. This will allow you to use any protocols you wish
  114.      for transferring packets and files in RAMail as well as using custom
  115.      command line parameters for these protocols.
  116.  
  117.      The Protocol Name field is for display purposes. Enter anything you want
  118.      in this field.
  119.  
  120.      The Program Name is the name of the protocol program, with extension. The
  121.      path is not reuqired (nor will it fit!), but the protocol program MUST
  122.      reside in a directory that is listed in your DOS path.
  123.  
  124.  
  125.  
  126.      The Send Command String field allows you to enter the command line that
  127.      will be passed to the protocol program. Three macro variables are avail-
  128.      able for you to use. These are #P, which is the COM port number to use,
  129.      #F, which is the file name that will be passed to the protocol, and #S,
  130.      which is the speed (baud rate) that will be passed to the protocol.
  131.  
  132.      The Receive Command String field is for the command line that will be
  133.      passed to the protocol used for receiving files. The same format applies
  134.      as for the Send Command String field.
  135.  
  136.      You can define up to 4 protocols.
  137.  
  138.      Multi-Node Sysops
  139.      -----------------
  140.      The RA file MESSAGES.RA will be searched for using the RA environment
  141.      variable. You should set this variable if you use multiple CONFIG.RA files
  142.      in separate directories. You can also pass the path and name of your
  143.      MESSAGES.RA file on the command line of RAMCONF, e.g.
  144.  
  145.      RAMCONF RAMAIL.CFG C:\RA\MESSAGES.RA
  146.